isCOBOL WebClient : WebClient commands : Startup configuration properties
Startup configuration properties
The following properties can be specified on the command-line to customize the pathname of the logs directory and the pathname of the tmp directory:
Property
Description
Default
jetty.request.header.size
Number of bytes as maximum request/response header size when using embedded Jetty
524288
webclient.configFile
Path to config file (including file name)
 
webclient.configReloadIntervalMs
Number of milliseconds for config reload interval
1000
webclient.cookieSameSite
Value for SameSite cookie attribute if server runs in HTTPS only mode
NONE
webclient.defaultWelcomePage
Path to default welcome page resource to show when "/" is accessed
/selector/index.html
webclient.disableHttpSecurityHeaders
Disable HTTP security headers - X-Frame-Options, X-Content-Type-Options, X-XSS-Protection, Referrer-Policy, Strict-Transport-Security
false
webclient.fileServletWaitTimeout
Number of milliseconds to wait for a file to be ready for download
300000
webclient.httpsOnly
Force https only, sets cookies as Secure and SameSite to NONE by default
true if https is enabled and http is disabled in jetty.properties
webclient.keep.instances
How many closed instances should be kept in memory. The instances can be viewed in Admin Console (-1 for infinite)
-1
webclient.logsDir
Specifies the directory where log files will be created. See Logging for the list of log files generated by WebClient commands.
This property takes a pathname in the form of a string and requires the file separator character at the end.
 
Example of valid setting:
 
webclient.logsDir=/tmp/logs/
 
If the directory doesn’t exist, it’s automatically created.
 
webclient.propertiesFile
Path to properties file (including file name)
 
webclient.rootDir
Root directory
${user.dir}
webclient.stats.historySize
Number of observations kept in memory
60
webclient.stats.interval
Granularity of the metrics, average of last N seconds
10
webclient.stats.latencyWarn
Threshold to generate a network latency warning (milliseconds)
700
webclient.stats.memUsageWarn
Threshold to generate a memory usage warning
0.8 (80%)
webclient.stats.pingWarn
Threshold to generate a ping warning (milliseconds)
500
webclient.tempDirPath
Specifies the directory where temp files will be created.
This property takes a pathname in the form of a URI and requires the file separator character at the end.
 
Example of valid setting:
 
webclient.tempDirPath=file:/tmp/
 
If the directory doesn’t exist, an error occurs.
 
webclient.warLocation
Location of WAR file
 
webclient.webclient.proxyContextPath
Explicit servlet context path
 
webclient.websocketMessageSizeLimit
Maximum size of websocket message in bytes
5242880
webclient.websocketMessageTimeout
Timeout for the websocket message to be sent in milliseconds
30000
You can pass the options directly on the command-line by prefixing them with -J-D.
Example
In order to start WebClient having log files created under C:\Temp\Logs, use the command:
webcclient -J-Dwebclient.logsDir=C:\Temp\Logs
Alternatively, only on Windows, you can add these options in the vmoptions file of the desired WebClient command.
Example
Content of webclient.vmoptions to have log files created under C:\Temp\Logs:
# isCOBOL WebClient setting added from isCOBOL WEBC2025.2 setup
# Comments in .vmoptions files are prefixed by a hash, each VM option is on
# a separate line
# -Discobol.conf=myconf.properties
#-Xmx256m
#-Xms128m
-classpath/p .
-XX:+HeapDumpOnOutOfMemoryError
-Dwebclient.logsDir=C:/Temp/Logs/